home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libxml-parser-perl / README < prev    next >
Text File  |  2003-07-27  |  3KB  |  87 lines
  1.             XML::Parser Version 2.31
  2.  
  3. Copyright (c) 1998-2000 Larry Wall and Clark Cooper.
  4. All rights reserved.
  5. This program is free software; you can redistribute it and/or modify it
  6. under the same terms as Perl itself. 
  7.  
  8. This is a Perl extension interface to James Clark's XML parser, expat.
  9. It requires at least version 5.004 of perl and it requires that you have
  10. release 1.95.0 or greater of expat installed. You can download expat
  11. from:
  12.  
  13.      http://sourceforge.net/projects/expat/
  14.  
  15. The documentation for this extension can be found in pod format at the end
  16. of the files Parser.pm and Expat/Expat.pm. The perldoc program, provided with
  17. the perl distribution, can be used to view this documentation.
  18.  
  19. This was modified from the original XML::Parser created by Larry Wall.
  20.  
  21. To configure this module, cd to the directory that contains this README file
  22. and type the following:
  23.  
  24.     perl Makefile.PL
  25.  
  26. Alternatively, if you plan to install XML::Parser somewhere other than
  27. your system's perl library directory. You can type something like this:
  28.  
  29.     perl Makefile.PL PREFIX=/home/me/perl INSTALLDIRS=perl
  30.  
  31. Then to build you run make.
  32.  
  33.     make
  34.  
  35. You can then test the module by typing:
  36.  
  37.     make test
  38.  
  39. There are some sample utilities in the samples directory along with an
  40. xml form of the XML specification to test them on. You may need to change
  41. the '#!' line at the top of these utilities to what is appropriate for
  42. your system. If you're going to play around with them prior to installing
  43. the module, you would need to add the blib paths to your perl search
  44. path, like this (assuming your current directory is samples):
  45.  
  46.     perl -I../blib/lib -I../blib/arch xmlcomments REC-xml-19980210.xml
  47.  
  48. or set your PERLLIB environment variable.
  49.  
  50. If you have write access to the installation directories, you may then
  51. install by typing:
  52.  
  53.     make install
  54.  
  55. Discussion on features and bugs of this software and general discussion
  56. on topics relating to perl and XML takes place on the perl-xml mailing
  57. list, to which you can subscribe by sending mail to:
  58.  
  59.     subscribe-perl-xml@lyris.activestate.com
  60.  
  61. Differences from Version 2.30
  62. =============================
  63.  
  64. Version 2.31 is a minor bugfix release to allow XML::Parser to
  65. work under the forthcoming Perl 5.8.0 release. There are no functional
  66. changes.
  67.  
  68. Differences from Version 2.29
  69. =============================
  70.  
  71. Expat is no longer included with this package. It must now be already
  72. installed on your system as a library. You may download the library
  73. version of expat from http://sourceforge.net/projects/expat/. After
  74. downloading, expat must be configured (an automatic script does this),
  75. built and installed.
  76.  
  77. A workaround has been provided for those people who couldn't compile
  78. Expat.xs with a perl 5.6.0 with USE_5005THREADS on.
  79.  
  80. A bug that prevented IO::Handler from being read by the parse method
  81. has been fixed.
  82.  
  83. Fixed a bug in reading external entities with incremental parsing.
  84.  
  85. Clark Cooper
  86.   coopercc@netheaven.com
  87.